Cream of the Crop 11/Cream of the Crop 11-2.iso/bbs/bbytrp42.zip/BOOBYTRP.DOC

Text File | 1995-12-26 | 23KB | 559 lines

                        * * * B O O B Y   T R A P * * *
                     Copyright 1991-1995 by M & S Software

Booby Trap Version 4.2
12/26/1995 M & S Software

Author: Mike Jordan

Built in BBS Support For:

  Wildcat! BBS 1.13 - 4.0+          PCBoard BBS 14.X+          QuickBBS
  Remote Access                     Spitfire BBS               GAP BBS
  RBBS-PC BBS                       T.A.G. BBS


*** Game Discription ***

Booby Trap is a game of skill and a little bit of luck.  You try to
find and flag the 25 booby traps amoung the 152 squares without triping
one of them.  You do this by clearing the squares one at a time and
based on the indicators for what is in adjacent squares, determine what
squares to mark.  There are bonus points awarded for speed in marking all
the booby traps.

Booby Trap does not use a Demo Key nor does it expire.  It has no annoying
beeps, whistles, slow downs or other devices to get you to register.  The
non-registered version does have a few limitations though. It only works
in single node mode and the scores are reset after 21 days and bulletins
are not created.  In addition the makeup and play-ahead feature is not
available.


Booby Trap now has InterBBS ability. Please read the INTERBBS.TXT file for
more details.

*** Warranty ***

This product is provided "as is" without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Furthermore, the author does not warrant, guarantee, or make any representa-
tions regarding the use of, or the results of the use of the program, and you
rely on the program and results solely at your own risk. The author cannot
accept responsibility for system damage, loss of profit, or any other special,
incidental, or consequential damages resulting from the use of or inability to
use this product.


*** Licensing ***

Upon registering you are granted a licensed BOOBYTRP.KEY, which gives you
certain limited rights to use Booby Trap.

You are granted the use of Booby Trap on a single BBS System. It may be used on
several CPUs in a Networking or Multi-Tasking environment where the BBS System
has more than one physically connected node (i.e. LAN Network).

You do not become an owner of Booby Trap.  M & S Software retains
all rights to the software, copies of the software and related
materials. Also upon registering, you agree to use reasonable efforts to
protect the registered BOOBYTRP.KEY file from unauthorized use, reproduction
and distribution.  All rights not specifically granted in this license are
reserved by M & S Software.

Failure to comply with this License can result in termination of the
License without refund.

*** Shareware Version - No Set Demo Period - Please Read ***

This door game is distributed under the SHAREWARE concept.  This
concept gives you the chance to "try before you buy", and see if it
meets your needs.

I've decided to break away from the standard "30 day trial period"
that many door authors are using and instead go to a much simpler
and more realistic policy. This is simply; Try it on your BBS...
If you like it and your users like it, then register it.  If it's not
good enough to register, then delete it.

While I'd like you to register my doors as soon as possible, I'm also
realistic enough to know that different boards have different requirements,
and interests, and sometimes it takes longer for a game catches on, or a
sysop can get to the Doors on his list to register.  And frankly, I'd rather
you ran it for awhile and register, than try it for a short period of time
and delete it. Nobody wins that way...I lose out on a registration and your
users lose out on the chance of having the registered door to play.

*** Four Ways To Run Booby Trap ***

1.  Running Locally:

To run locally you must first create a BOOBYTRP.CFG file.  To create this file
run BT_SETUP.COM and fill in the fields that are presented or just type
BOOBYTRP.EXE at the DOS prompt and the Setup program will run.  The .CFG file
can also be created or edited with any ASCII editor.  See the example
BOOBYTRP.CFG file for the lines required.

Then at the DOS prompt type:

        BOOBYTRP BOOBYTRP.CFG LOCAL

By specifying the configuration file this will allow the game to write the
bulletins (to a path of your choice) and to allow the game to use the Sysop's
real name instead of the name "Sysop".

2.  Running in Evaluation Mode:

Booby Trap does not need a Demo Key to run in evaluation mode.  Create a
BOOBYTRP.CFG and setup as described later in this documentation and you are
all set.  The evaluation mode will give you all the features of the
registered version EXCEPT that Bulletins will not be created, the multi-node
option will not function and the dedication line will not be implemented. In
addition the game will reset the score board every 21 days (the reset at the
1st of each month is normal) and continue as if it was the first of the month.

3.  Running as a Registered Door:

You must have the Registration Key to run as a registered door. To register
simply print-out or copy the contents of the REGISTER.FRM file provided
in this package. Fill it out with the requested information and send it
with check, money order or COD information to the address on the form itself
or at the end of this documentation.  You may also call the information in
or send the information by Net Mail or upload it to my board for Charge Card
orders.

Upon receipt of your order you will be sent your registered key.  This
will be done, via Net-Mail where applicable, upload to your BBS if
possible or by U.S. Mail.  All COD orders will be sent UPS or U.S. Mail.
** Note: All COD fees will be added to the registration price.

4.  Running in InterBBS Mode:

Read the INTERBBS.TXT file for information on running Booby Trap in
InterBBS mode.


*** Support ***

I will do my best to help with any problems encountered weither the game
is registered or not.

If you register this door, I will do my best to ensure that the registered
key is sent promptly.  I will do the best I can to support this door and
resolve any problems that might arise.  I can't guarantee to fix or resolve
all problems since there are so many different combinations of hardware,
software and system configurations being used but I will do my best.

Support can be obtained by calling voice, my BBS, by mail or though the FIDO
Network.  All the numbers can be found at the bottom of this documentation.

*** Features ***

       * Supports Wildcat 1.13 - 4.0+, QuickBBS, PCBoard 14.X, Gap,
         Spitfire, RBBS-PC, Remote Access 1.x & 2.x, T.A.G., WWIV, Telegard,
         Synchronet, TriBBS, VBBS, Ultra BBS, PowerBBS, Powerboard,
         Renegade, Searchlight (and any others that use these same type Door
         drop files) without the use of converters.

       * Detects & Adjusts Screen For RIP Graphics. Eliminates the
         scrunched screen appearance.

       * Makeup missed game feature. (Requires Registered Key)

       * File Sharing & Record Locking for Networks & Multi-Tasking Systems.
         (Feature requires Registered Key File.)

       * DESQview Detection & Awareness, which speeds program execution.

       * Complete Setup Program to create the BOOBYTRP.CFG file.

       * Full ANSI Game.

       * Full Spilt-Screen Chat.

       * Sysop can Add or Decrease Time allowed in door with function keys.

       * Sysop can force user back to BBS with function key.

       * Mono selected colors for sharp picture when played in Mono Mode.

       * Built in bulletin generator for ANSI and ASCII bulletins (registered
         version only).

       * Selectable In-depth Log File capability.

       * Carrier Drop Detection.

       * No Input In 5 Minutes, Time Out Detection.

       * Full BBS and FIDO Support (Demo or Registered)

       * Supports Comm Ports 1, 2, 3 & 4 And Non-Standard IRQ selection.

       * Supports Locked DTE Rate up to 115,200 Baud.

       * Supports FOSSIL detection

*** Files In Archive ***

The following files are found either in the BOOBYTRP.ZIP or will be
created during the runtime execution.

BOOBYTRP.EXE    <--- Executable Program.

BOOBYTRP.CFG  * <--- Sample Configuration File.

BOOBYTRP.DAT  * <--- Store User's Name, Last Play Date & Scores.

BOOBYTRP.HPS    <--- Ansi Mode Instructions Used By Program.

BOOBYTRP.DOC    <--- This File.

BOOBYTRP.ASC    <--- ASCII MONO Mode Opening Screen.

BOOBYTRP.ANS    <--- ANSI COLOR Mode Opening Screen.

BOOBYTRP.CHP  * <--- Last Month's Champion File.

BOOBYTRP.LOG  * <--- Game Activity Log.

BOOBYTRP.MSG  * <--- FeedBack Text File

DOOR.BAT        <--- Simple Sample Batch File For Door Execution.

REGISTER.FRM    <--- Registration Form For This And Other Doors.

HISTORY.TXT     <--- History file listing changes.

UPGRADE.TXT     <--- Explains what is needed to upgrade to new release
                     from previous one.

BOOBYTRP.KEY    <--- Registration key. (Not needed for Evaluation mode)

SUPPORT.TXT     <--- List of boards carring the latest version.

BOOBYTRP.FBK  * <--- File that keeps Sysop Feedback information

LEAGUE.BT       <--- InterBBS League list

MASTER.BT     * <--- The Master InterBBS Score file that is passed to other
                     boards playing in the IBBS League.

TIMESTMP.DAT  * <--- Created and updated when BOOBYTRP IBBS is run.  Shows
                     on IBBS score screen when last time IBBS was run.

WHOSWHO.DAT   * <--- The InterBBS list of WHO's WHO in the League.

BT-?.DAT      * <--- Created by each node when playing InterBBS. This file
                     is passed back to the Master Hub.

IBBS.CHP      * <--- Last months InterBBS Champion

NOFEEDBK      * <--- When file exists in the Booby Trap directory, the Sysop
                     Feedback option will be turned off. Remove it to turn it
                     on.

* DENOTES that file is created during RUN-TIME.


BOOBYTRP.CHP contains:

This is the Last Month's Champion file. It contains the Champ's Name, Score,
Date and How many games won that month. This file is automatically created
when the game is first executed.

Deleting the BOOBYTRP.CHP file will cause the game to re-initialize
itself. It will create a new BOOBYTRP.CHP file and a new BOOBYTRP.DAT file.


*** Setup & Installation ***

Installation procedures are very simple if you have setup a live program in
the past. First create a Sub-Directory for the door game and copy all the
files from the BBYTRP*.ZIP file into this directory.

Now execute the Setup program by typing BOOBYTRP SETUP with no parameters at
the DOS prompt.  You must be in the directory with BOOBYTRP.EXE.

This will run the game's setup feature that will create a BOOBYTRP.CFG
file. The setup program has complete on-line help so I will not duplicate
them here.

Single Node Setup:

** See the section on Multi-Node for the changes
   required to line 1 and 6 in a Multi-Node setup.

This is what the BOOBYTRP.CFG contains when created (less the comments).

   1                        <-- COM PORT 1, 2, 3, 4 or &H###/#
   N                        <-- Multi-Node 'Y' or 'N'
   COM-DAT BBS              <-- Name Of BBS
   Mike Jordan              <-- Sysop's Full Name
   DOOR.SYS                 <-- BBS Callers File
   C:\WC30\WCWORK\NODE1\    <-- Drive & Path Of System's Caller File
   LOG                      <-- LOG to keep user log or NOLOG to disable
   C:\BULLETIN\BULL99.BBS   <-- Drive\Path\BulletinName For Ansi Scores
   C:\BULLETIN\BULL99.SCR   <-- Drive\Path\BulletinName For Ascii Scores
   Wildcat                  <-- Type of BBS System You're Running See Note 1
   Thanks For The Donations <-- 50 character dedication line
   5                        <-- Games Allowed Per Day (1 to 99)
   SAFE                     <-- Safe Square Active or NOSAFE for Not Active
   5                        <-- Number of Missed Games that can be Made up

NOTE 1: Valid System Callers files for each BBS system are as follows:

            Wildcat 3.X BBS System         <->  USERINFO.DAT or DOORS.SYS
            Wildcat! 1.X & 2.X BBS System  <->  CALLINFO.BBS
            QuickBBS System                <->  DORINFOx.DEF
            RBBS-PC BBS System             <->  DORINFOx.DEF
            Remote Access 1.x BBS System   <->  DORINFOx.DEF
            Remote Access 2.x BBS System   <->  DORINFOx.DEF or DOORS.SYS
            T.A.G. BBS System              <->  DORINFOx.DEF
            PCBoard BBS System             <->  PCBOARD.SYS
            Gap BBS System                 <->  DOORS.SYS
            Spitfire BBS System            <->  SFDOORS.DAT

If you use another BBS System besides those listed, then you must use
a converter to convert to one of the above caller file formats.

** The Bulletin Drive\Path\Bulletin Name is designed to accept any valid
Drive, Path and Filename of your choice. This allows each BBS system to
configure for it's individual system.

Note 2: Line 11 (the dedication line) is required, even
if it is a blank line.

*** Execution ***

Some BBS Systems call batch files and some run doors directly. If you
don't know how to install a door on your particular BBS System then please
see your BBS manual. This game merely needs the .CFG file name passed to it on
the command line to operate, i.e. (Note: The config file MUST be named
                                   BOOBYTRP.CFG or the game will not work)

          BOOBYTRP.EXE BOOBYTRP.CFG

An example BOOBYTRP.BAT file could look like this:

     C:                         <-- Change to drive door is in
     CD \BOOBYTRP               <-- Change to door directory
     BOOBYTRP.EXE BOOBYTRP.CFG  <-- Execute door with config file
     CD\BBS                     <-- Change back to BBS (may not be needed)


Some systems (particular those with 486 PCs) may need to put in the
FOSSILOFF command.  This would look like this:

   BOOBYTRP.EXE BOOBYTRP.CFG FOSSILOFF

  Read the file FOSSIL.TXT included in the BOOBYTRP.ZIP file.

*** Multi-Node Use ***

Running this game on more than a single node requires a Registered Key.
When running in Evaluation mode, only one (1) Node will be able to access the
door at a time but it is accessable from any node.

*** Environmental Variable Support ***

  Setting Ports using Environment Variables: If your running a Multi-Node
  BBS system then you need to use environment variables. The game allows any
  variable name to be used, but I will use the name WCPORTID just for
  clarity. To specify the port using an environment variable you place the
  name of the variable on this line wrapped in percent signs, ie %WCPORTID%.
  This will tell the game to read this variable from the environment to get
  the com port information. One limit to this is the syntax which must keep in
  context when not using variables and this is when using non-standard port
  addressing. When using non-standard port addressing the syntax must be the
  same as explained above (ie. &H3F8/5). Some BBS packages use a different
  variable for each of these. If this is your case then merely create another
  by adding SET WCPORTID=&H3F8/5 to your BBS starting batch file and then use
  %WCPORTID% as the com port of the configuration file. See Multi-Node Setup
  below for more information.


  The setup of Booby Trap changes the way my previous doors are setup.
  I now support and require the use of Environment Variables to supply the
  game with the Com Port and Node Directory information. The game will
  read any environment variable that you supply so names are not critical.

  The game now only reads the BOOBYTRP.CFG file and will not accept any
  other name for the configuration file. So this is the file that will contain
  the environment variables.

  The game requires only two pieces of information. This is the Com Port
  and Node Directory information and these must be supplied with environment
  variables.

  The environment variables is best set by your BBS's calling batch file.
  This is the batch file that starts your BBS. If your running a Wildcat or
  PCBoard BBS system then you probably already use the WCNODEID or PCBNODE
  environment variables. These variables should work fine. If your using
  another BBS system then you will probably have a similar variable. If not
  just use the default ones used below in the example setup.

  Since I run Wildcat! software I am going to use WCPORTID and WCNODEID for
  my example of setting up on a Multi-Node system.  Also I will assume you need
  to add the environment variables where in fact most cases they will already
  be in use.

Step 1:

  You will need to add the following lines to your batch files that start
  your BBS. These lines should be located near the top of the file ahead
  of any loop since they only need to be initialized one time:

     SET WCPORTID=1    This is your com port environment variable
                       and assigns the com port for each node.

     SET WCNODEID=1    This is your node id environment variable
                       and assigns the node number for each node.

  The WCPORTID is the tricky one of the two. Where the WCNODEID merely
  assign the node number the WCPORTID may also have to assign a Non-Standard
  Port address and IRQ. See above 'Line #1 Com Port' for explanation of this.


  I will give a few examples setting the WCPORTID variable to try to avoid
  confusion.

     SET WCPORTID=2         '--- Use Com Port #2 with IRQ 3 (standard)

     SET WCPORTID=&H3E8/5   '--- Use Com Port #3 with IRQ 5


  The environment variables are used on lines #1 and #6 of the configuration
  file. Below is the first 7 lines of the configuration file with the
  environment variables in place. See above if you need to see the complete
  file. (exclude the comments).

    %WCPORTID%                <-- COM PORT 1, 2, 3, 4 or &H###/# or %WCPORTID%
    Y                         <-- Make Sure This Is 'Y'es
    Com-Dat BBS               <-- Name Of BBS
    Mike Jordan               <-- Sysop's Full Name
    DOOR.SYS                  <-- BBS Drop File
    C:\BBS\NODE%WCNODEID%\    <-- Drive & Path Of Systems Caller File
    LOG                       <-- LOG to keep user log or NOLOG to disable
    ...etc...

  The game will read in these lines and will check lines #1 and #6 for
  environment variables and thus read in their information. Line #6 assumes
  the DOOR.SYS file will be placed in the C:\BBS\NODE1\ sub-directory if
  WCNODEID equals 1.

  If you are already using environment variables with your current BBS setup
  that meet the games need you can merely use those instead.

  That's all there is too it.

** COMMANDS **

    COMMAND Line Parameters: SETUP  LOCAL  ALIAS  FOSSIL  SPLIT  IBBS

    This door has several command line parameters listed above. Below is
    description for usage:

    SETUP       - Run's the Booby Trap Setup program.

    LOCAL       - Used in conjunction with FILENAME.CFG LOCAL for executing
                  the door in local only mode. For use from the DOS prompt
                  only. Never use LOCAL in a BBS batch file.

    ALIAS       - Cause's the door to use Alias names on BBS System's
                  which support the DOOR.SYS drop file.

    FOSSIL      - Cause's the door to use a previously installed fossil.

    SPLIT       - Just a toy. This will cause the game to split the opening
                  registration screen from the display.

    IBBS        - Used to run InterBBS maintenance to create the MASTER.BT
                  file and to update the Who's Who list.

  In some cases more than one option will be needed, such a case being
  when using a fossil and also using alias names. The command line to execute
  the game would look like this:

                           BOOBYTRP.EXE BOOBYTRP.CFG FOSSIL ALIAS

                      Order of the option does not matter.


*** Notes Of Interest ***

This game does not require a monitoring program for dropped carrier as
it automatically detects this and exits back to the BBS.

This door DOES NOT require any runtime modules. It will run
as is without aid from outside utilities.


*** Technical Support ***

If you have problems with this door game you can contact me through either
by voice, through my BBS at the numbers listed below, or though my FIDO
addresses 1:105/314, 1:105/317 or 1:105/330.

BBS Phone:       Com-Dat
                 Voice Support and Order: [phone]
         Node 1 - [phone] (14.4 v.32)
         Node 2 - [phone] (14.4 v.32)
                 Node 3 - [phone] (28.8 Hayes)
         FIDO 1:105/314 (14.4 v.32)
                 FIDO 1:105/317 (14.4 v.32)
                 FIDO 1:105/330 (28.8 Hayes)
         24 hour - First time callers have access to
                 door programs.  Fast Login using name of Door Games
                 and Password of DOORS.

Mailing Address: Mike Jordan
                 2001 NE Hyde St.
                 Hillsboro, OR.  97124
                 Voice Support and Orders: [phone]

*** Ordering Information ***

Please see the file REGISTER.FRM file in this package for ordering
information.

*** Updates To "M & S Doors" ***

Updates to any M & S Software product may be downloaded from any Distribution
BBS.  My intent is to always supply updates FREE unless major revisions are
made to the software, in which case a small update fee will be charged.

*** Distribution ***

You are free, in fact encouraged, to distribute the SHAREWARE BOOBYTRP.ZIP
version of the door game provided that all files contained in the original
BOOBYTRP.ZIP archive are distributed in their original unmodified state.

The Registered Key MAY NOT be distributed in any form.


*** Acknowledgements ***

              Wildcat BBS System - Mustang Software
              GAP Communications - The GAP Development Company
              PCBoard - Clark Development Company, Inc.
              Spitfire - Mike Woltz, Buffalo Creek Software
              QuickBBS - The QuickBBS Group, Inc
              Remote Access - Wantree Development

*** Special Acknowledgement ***

I would like to give a very big thank you to the person that has done the
most to make this game (plus all my past and hopefully future door games)
possible.  This person is Rusty Johnson of JNS Software. Rusty has released
many excellent door games into the BBS arena and if you haven't taken a look
at any of them you are missing out on some of THE best door games available.
Rusty and I have known each other for several years now and have helped each
other many times and this is one case where giving has been rewarded tenfold.
I'm glad to be able to call Rusty my friend.  Thanks Rusty.




Booby Trap Copyright 1991-1995 by M & S Software